Skip to content

Deprecate ingress-nginx docs, promote Gateway API#3105

Merged
mcharriere merged 4 commits into
mainfrom
deprecation-ic
May 18, 2026
Merged

Deprecate ingress-nginx docs, promote Gateway API#3105
mcharriere merged 4 commits into
mainfrom
deprecation-ic

Conversation

@mcharriere
Copy link
Copy Markdown
Contributor

Ingress NGINX is no longer offered by Giant Swarm. Archive the ingress
section by removing it from the navigation and adding deprecation notices
to each page pointing users to Gateway API with Envoy Gateway.

  • Add reusable notice shortcode for styled warning banners
  • Rewrite ingress/_index.md as a deprecation landing page (hidden from nav)
  • Remove menu entries from all four ingress sub-pages (hidden from nav)
  • Add deprecation notice to each sub-page body
  • Lower gateway-api section weight (25 → 15) to promote it in the nav

What this PR does / why we need it

Things to check/remember before submitting

  • If it's one of your first contributions, make sure you've read the Contributing Guidelines.
  • Bump last_review_date in the front matter header of the pages you've touched.

@mcharriere mcharriere requested a review from a team as a code owner May 12, 2026 09:13
@mcharriere
Copy link
Copy Markdown
Contributor Author

Screenshot 2026-05-12 at 10-35-38 Connectivity – Giant Swarm Documentation Screenshot 2026-05-12 at 11-12-45 Ingress connectivity (deprecated) – Giant Swarm Documentation Screenshot 2026-05-12 at 11-13-08 Advanced ingress configuration – Giant Swarm Documentation

@mcharriere mcharriere requested a review from a team May 12, 2026 21:07
Copy link
Copy Markdown
Contributor

@pipo02mix pipo02mix left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please bump last_review_date in all modified files

Ingress NGINX is no longer offered by Giant Swarm. Archive the ingress
section by removing it from the navigation and adding deprecation notices
to each page pointing users to Gateway API with Envoy Gateway.

- Add reusable `notice` shortcode for styled warning banners
- Rewrite ingress/_index.md as a deprecation landing page (hidden from nav)
- Remove menu entries from all four ingress sub-pages (hidden from nav)
- Add deprecation notice to each sub-page body
- Lower gateway-api section weight (25 → 15) to promote it in the nav
- Replace NGINX with Nginx per project terms
- Use colon instead of em dash in archived pages list (em dash was
  confusing Vale's parser when adjacent to Hugo shortcode syntax)
- Lowercase 'Upstream' used as adjective in further reading links
@mcharriere mcharriere added this pull request to the merge queue May 18, 2026
Merged via the queue into main with commit d6dd0f8 May 18, 2026
6 checks passed
@mcharriere mcharriere deleted the deprecation-ic branch May 18, 2026 06:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants